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1. Introduction 


This document is the non-proprietary security policy for the OpenSSL FIPS Object Module. This 
document was prepared as part of the Federal Information Processing Standard (FIPS) 140-2 Level 1 
validation process. 


FIPS 140-2, Security Requirements for Cryptographic Modules, describes the requirements for 
cryptographic modules. For more information about the FIPS 140-2 standard and the cryptographic 
module validation process see http://csrc.nist.gov/cryptval/. 


2. Module Specification 


The OpenSSL FIPS Object Module (hereafter referred to as the Module) is a software library 
supporting FIPS-approved cryptographic algorithms. For the purposes of the FIPS 140-2 level 1 
validation, the OpenSSL FIPS Object Module v1.2.4 is a single object module file named 
fipscanister.o (Linux9?!'/Unix*? and VxWorks9?) or fipscanister.lib (Microsoft Windows). This 
module provides a C-language application program interface (API) for use by other processes that 
require cryptographic functionality. 


Note that the OpenSSL FIPS Object Module v1.2.4 is fully backwards compatible with all earlier 
revisions of the OpenSSL FIPS Object Module v1.2. The v1.2.4 Module incorporates support for a 
new platform without disturbing functionality for any previously tested platforms. The v1.2.4 Module 
can be used in any environment supported by the earlier revisions of the Module, and those earlier 
revisions remain valid. 


For FIPS 140-2 purposes the Module is classified as a multi-chip standalone module. The logical 
cryptographic boundary of the Module is the fipscanister object module. The physical cryptographic 
boundary of the Module is the enclosure of the computer system on which it is executing. The Module 
performs no communications other than with the process that calls it. It makes no network or 
interprocess connections and creates no files. 


The Module was tested on the following platforms: 


Platform Platform 
# 
1 Linux x86 no-asm, Linux.2.6.18 i686 gcc-4.1.2 (OpenSuSE 10.2) no- 
asm 
2 Linux x86-64 no-asm, Linux.2.6.20 x86-64 gcc-4.1.2 (OpenSuSE 10.2) 
3 Linux x86 asm, Linux.2.6.18 i686 gcc-4.1.2 (OpenSuSE 10.2) 


Linux is the registered trademark of Linus Torvalds in the U.S. and other countries. 

UNIX is a registered trademark of The Open Group 

VxWorks is a registered trademark owned by Wind River Systems, Inc 

Windows is a registered trademark of Microsoft Corporation in the United States and other countries. 


BRWN Re 
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Platform Platform 
# 
4 Linux x86-64 asm, Linux.2.6.20 x86-64 gcc-4.1.2 (OpenSuSE 10.2) 
5 Windows x86 no-asm, WinXP.SP2 i386 MSVC.8.0 no-asm 
6 Windows x64 no-asm, WinXP.SP2 x86-64 MSVC.8.0 no-asm 
pi Windows x86 asm, WinXP.SP2 i386 MSVC.8.0 NASM, SSE2 
8 Windows x64 asm, WinXP.SP2 x86-64 MSVC.8.0 
9 Linux ARM no-asm, Linux.2.4.32-uc0 armv4l gcc-3.4.4 (uCLinux) 
10 Linux ARM no-asm, Linux.2.6.32.9-959f039501 armv7l gcc-4.4.0 
(Android2.2) 
11 Vxworks PowerPC hard float, powerpc-wrs-vxworks gcc 4.1.2 
12 Vxworks PowerPC soft float, powerpc-wrs-vxworks gcc 4.1.2 
13 Wind River 1.4, Linux 2.6.27, Freescale PowerPC-32 
14 Wind River 4.0, Linux 2.6.34, Freescale PowerPC-32 
15 Apple i0S 5.0, gcc version 4.2.1, ARMv7 
16 Apple OS X 11, gcc version 4.2.1 (32 bit) 
17 Apple 0S X 11, gcc version 4.2.1 (64 bit) 
Table 2.1 


The “asm” designation means that assembler language optimizations were enabled when the binary 
code was built, “no-asm” means that only C language code was compiled. 


These platforms correspond to the Operational Environment configurations listed on the FIPS 140-2 
Validation Certificate #1051 as follows: 


Operational Environment Configuration Platform 
OpenSuSE Linux 32-bit Version 10.2 (gcc Compiler Version 1, 3 
4.1.2 20061115 prerelease) 
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Operational Environment Configuration Platform 


OpenSuSE Linux 64-bit Version 10.2 (gcc Compiler Version 2, 4 
4.1.2 20061115 prerelease) 


Windows XP Pro SP2 32 bit (Microsoft Visual C++ version 8) 


5, 7 
Windows XP Pro SP2 64 bit (Microsoft Visual C++ version 8) 6, 8 
uClinux Kernel Version 2.4.32 (gcc Compiler Version 3.4.4) 9 


Android 2.2 (gcc Compiler Version 4.4.0) 10 
VxWorks 6.7 (gcc Compiler Version 4.1.2) 11, 12 
Wind River Linux 1.4 (gcc compiler 3.4.4) 13 
Wind River Linux 4.0 (gcc compiler 4.4.1) 14 
Apple i0S 5.0 (gcc compiler 4.2.1) 15 
Apple OS X 11 32 bit (gcc compiler 4.2.1) 16 
Apple OS X 11 64 bit (gcc compiler 4.2.1) 17 
Table 2.2 
FIPS Object Module Block Diagram sion 


a a ae v1.2 — —F| Ciphertext 


Physical Cryptographic Boundary 


Logical Cryptographic Boundar 


FIPS Object c Module 
E 
Ps x 
| 
CPU CPU Controller Peripherals 


r 


Input Output 


Figure 2 
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2.1 Roles and Services 


The Module meets all FIPS 140-2 level 1 requirements for Roles and Services, implementing both 
Crypto-User and Crypto-Officer roles. As allowed by FIPS 140-2, the Module does not support user 
authentication for those roles. Only one role may be active at a time and the Module does not allow 
concurrent operators. 


The User and Crypto Officer roles are implicitly assumed by the entity accessing services implemented 
by the Module. The Crypto Officer can install and initialize the Module. The Crypto Officer role is 
implicitly entered when installing the Module or performing system administration functions on the 
host operating system. 


e User Role: Loading the Module and calling any of the API functions. This role has access to all of 
the services provided by the Module. 


e Crypto-Officer Role: Installation of the Module on the host computer system. This role is assumed 
implicitly when the system administrator installs the Module library file. 


Service Role CSP Access 

Symmetric encryption/decryption | User, Crypto Officer | symmetric key read/write/execute 
AES, TDES 

Key transport User, Crypto Officer asymmetric private key read/write/execute 
RSA 

Digital signature User, Crypto Officer asymmetric private key read/write/execute 
RSA, DSA 

Symmetric key generation User, Crypto Officer symmetric key read/write/execute 
AES, TDES 

Asymmetric key generation User, Crypto Officer asymmetric private key read/write/execute 
RSA, DSA 

Keyed Hash (HMAC) User, Crypto Officer HMAC SHA-1 key read/write/execute 
HMAC-SHA-1 

Message digest (SHS) User, Crypto Officer | none read/write/execute 
SHA-1, SHA-2 

Random number generation User, Crypto Officer |seed key read/write/execute 
seed 
AES 

Show status User, Crypto Officer | none execute 

Module initialization! User, Crypto Officer | none execute 

Self test User, Crypto Officer | none execute 

Zeroize User, Crypto Officer symmetric key, asymmetric 


] The FIPS mode initialization is performed when the application invokes the FIPS mode set() call which returns a *1" for 
success and “0” for failure; see section 2.3. 
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Service Role CSP Access 
key, HMAC-SHA-1 key, 
seed key 
AES 
Table 2.3 


2.2 Ports and Interfaces 


The physical ports of the Module are the same as the computer system on which it is executing. The 
logical interface is a C-language application program interface (API). 


The Data Input interface consists of the input parameters of the API functions. The Data Output 
interface consists of the output parameters of the API functions. The Control Input interface consists of 
the actual API functions. The Status Output interface includes the return values of the API functions. 


FIPS Interface Physical Port Module Interface 
Data Input Ethernet ports API input parameters 
Data Output Ethernet ports API output parameters 
Control Input Keyboard, Serial port, Ethernet port | API function calls 
Status Output Keyboard, Serial port, Ethernet port | API return codes 
Power Input PCI Compact Power Connector N/A 

Table 2.4 


2.3 Self Tests 


The Module performs both power-up self tests at module initialization? and continuous condition tests 
during operation. Input, output, and cryptographic functions cannot be performed while the Module is 
in a self-test or error state as the module is single threaded and will not return to the calling application 
until the power-up self tests are complete. If the power-up self tests fail, subsequent calls to the module 
will fail and thus no further cryptographic operations are possible. 


Power-Up Self Tests 


Algorithm Test 
AES KAT 


2 The FIPS mode initialization is performed when the application invokes the FIPS mode set() call which returns a “1” 
for success and “0” for failure; see section 2.3. 
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Algorithm Test 
Triple-DES KAT 
DSA pairwise consistency test, 
sign/verify 
RSA KAT 
PRNG KAT 
HMAC-SHA-1 KAT 
HMAC-SHA-224 KAT 
HMAC-SHA-256 KAT 
HMAC-SHA-384 KAT 
HMAC-SHA-512 KAT 
SHA-1 KAT? 
SHA-224 KAT! 
SHA-256 KAT! 
SHA-384 KAT! 
SHA-512 KAT! 
module integrity HMAC-SHA-1 
Table 2.5a 
Conditional Self Tests 
Algorithm Test 
DSA pairwise consistency 
RSA pairwise consistency 
PRNG continuous test 
Table 2.5b 


A single initialization call, FIPS mode set(), is required to initialize the Module for operation in the 
FIPS 140-2 Approved mode. When the Module is in FIPS mode all security functions and 
cryptographic algorithms are performed in Approved mode. 


The FIPS mode initialization is performed when the application invokes the FIPS mode set() call 
which returns a “1” for success and “0” for failure. Interpretation of this return code is the 
responsibility of the host application. Prior to this invocation the Module is uninitialized in the non- 
FIPS mode by default. 


3 Tested as part of the HMAC known answer tests. 
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The FIPS mode set() function verifies the integrity of the runtime executable using a HMAC-SHA-1 
digest computed at build time. If this computed HMAC-SHA-1 digest matches the stored known digest 
then the power-up self-test, consisting of the algorithm specific Pairwise Consistency and Known 
Answer tests, is performed. If any component of the power-up self-test fails an internal global error 
flag is set to prevent subsequent invocation of any cryptographic function calls. Any such power-up 
self test failure is a hard error that can only be recovered by reinstalling the Module‘. If all components 
of the power-up self-test are successful then the Module is in FIPS mode. The power-up self-tests may 
be performed at any time with a separate function call, FIPS selftest(). This function call also 
returns a “1” for success and “0” for failure, and interpretation of this return code is the responsibility 
of the host application. 


A power-up self-test failure can only be cleared by a successful FIPS mode set() invocation. No 
operator intervention is required during the running of the self-tests. 


2.4 Mitigation of Other Attacks 


The Module does not contain additional security mechanisms beyond the requirements for FIPS 140-2 
level 1 cryptographic modules. 


2.5 Physical Security 


The Module is comprised of software only and thus does not claim any physical security. 


4 The FIPS mode set() function could be re-invoked but such re-invocation does not provide a means from recovering 
from an integrity test or known answer test failure. 
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3. Secure Operation 


The tested operating systems segregate user processes into separate process spaces. Each process space 
is an independent virtual memory area that is logically separated from all other processes by the 
operating system software and hardware. The Module functions entirely within the process space of 
the process that invokes it, and thus satisfies the FIPS 140-2 requirement for a single user mode of 
operation. 


The Module is installed using one of the set of instructions in Appendix A appropriate to the target 
system. A complete revision history of the source code from which the Module was generated is 
maintained in a version control database. The HMAC-SHA-1 of the Module distribution file as tested 
by the CMT Laboratory and listed in Appendix A is verified during installation of the Module file as 
described in Appendix A. 


Upon initialization® of the Module, the module will run its power-up self tests. Successful completion 
of the power-up self tests’ ensures that the module is operating in the FIPS mode of operation. 


As the Module has no way of managing keys, any keys that are input or output from applications 
utilizing the module must be input or output in encrypted form using FIPS approved algorithms. 


The self-tests can be called on demand by reinitializing the module using the FIPS mode set() 
function call, or alternatively using the FIPS selftest() function call. 


Nn 


See http://cvs.openssLorg/ 
6 The FIPS mode initialization is performed when the application invokes the FIPS mode set() call which returns a “1” 


for success and “0” for failure; see section 2.3. 
7 The power-up self tests are performed as part of the FIPS mode initialization process; see section 2.3. 


Page 13 of 21 


OpenSSL FIPS 140-2 Security Policy 


4. Cryptographic Key Management 


4.1 Key Generation 


The Module supports generation of DH, DSA, and RSA public-private key pairs. The Module employs 
an ANSI X9.31 compliant random number generator for creation of asymmetric and symmetric keys. 


The developer shall use entropy sources that contain at least 128 bits of entropy to seed the RNG as the 
module is not capable of detecting randomness or quality of the seeding material provided. 


4.2 Key Storage 


Public and private keys are provided to the Module by the calling process, and are destroyed when 
released by the appropriate API function calls. The Module does not perform persistent storage of 
keys. 


4.3 Key Access 


An authorized application as user (the Crypto-User) has access to all key data generated during the 
operation of the Module. 


4.4 Key Protection and Zeroization 


Keys residing in internally allocated data structures can only be accessed using the Module defined 
API. The operating system protects memory and process space from unauthorized access. Zeroization 
of sensitive data is performed automatically by API function calls for intermediate data items, and on 
demand by the calling process using Module provided API function calls provided for that purpose. 


Only the process that creates or imports keys can use or export them. No persistent storage of key data 
is performed by the Module. All API functions are executed by the invoking process in a non- 
overlapping sequence such that no two API functions will execute concurrently. 


The calling process can perform key zeroization of keys by calling an API function. 


4.5 Cryptographic Algorithms 
The Module supports the following FIPS approved or allowed algorithms: 


Algorithm Validation Certificate Usage Keys/CSPs 
AES #695, #1534, #1630, #1933, |encrypt/decrypt | AES keys 128, 192, 256 bits 
#2011 
TDES #627, #1011, #1066, #1259, |encrypt/decrypt | Triple-DES keys 168 bits 
#1297 
DSA #264, #475, #512, #616, sign and verify |DSA keys 1024 bits 
#637 
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Algorithm Validation Certificate Usage Keys/CSPs 
PRNG (ANSI X9.31 #407, #826, #873, #1018, random number | PRNG seed value is 128 bits; 
Appendix A.2.4 using | #1053 generation seed key values are 128 bits, 192 
AES) bits, and 256 bits 
RSA (X9.31, PKCS #323, #745, #804, #999, sign and verify | RSA keys 1024 to 16384 bits 
311.5, PSS) 311040 
RSA encrypt/decrypt (allowed in FIPS mode, see | key wrapping RSA (key wrapping; key 

caveat below) establishment methodology 
provides 80 to 256 bits of 
encryption strength 
SHA-1 #723, #1362, #1435, #1698, | hashing N/A 
#1761 
SHA-224 #723, #1362, #1435, #1698, | hashing N/A 
#1761 
SHA-256 #723, #1362, #1435, #1698, | hashing N/A 
#1761 
SHA-384 #723, #1362, #1435, #1698, | hashing N/A 
#1761 
SHA-512 #723, #1362, #1435, #1698, | hashing N/A 
#1761 
HMAC-SHA-1 #373, #892, #957, #1167, message HMAC key 
#1216 integrity 
HMAC-SHA224 #373, #892, #957, #1167, message HMAC key 
#1216 integrity 
HMAC-SHA256 #373, #892, #957, #1167, message HMAC key 
#1216 integrity 
HMAC-SHA384 #373, #892, #957, #1167, message HMAC key 
#1216 integrity 
HMAC-SHAS512 #373, #892, #957, #1167, message HMAC key 
#1216 integrity 
Table 4.5a 


DSA supports a key size of less than 1024 bits except when not in FIPS mode. 


RSA (key wrapping; key establishment methodology provides between 80 and 256 bits of encryption 


strength). 


The Module supports the following non-FIPS approved algorithms: 


Algorithm 


Usage 


Keys/CSPs 


Diffie-Hellman 


key establishment 


Diffie-Hellman keys 


Table 4.5b 
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The Module only provides functions that implement Diffie-Hellman primitives. The shared secret 
provides between 80 and 219 bits of encryption strength. 
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Appendix A 


The test platforms represent different combinations of installation instructions and “code paths" -- the 
distinct set of object code generated depending on the host hardware and operating system platform. 
For each of these code paths there is a build system, the host providing the build environment in which 
the installation instructions are executed, and a target system on which the generated object code is 
executed. The build and target systems may be the same type of system or even the same device, or 
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Installation Instructions 


may be different systems. 


Platform Code Path Installation Instruction Set 
1 pure C 32 bit Ul 
2 pure C 32 bit Wi 
3 pure C 64 bit U1 
4 pure C 64 bit Wi 
5 x86 asm U2 
6 x86 asm W2 
7 x86-64 asm U2 
8 x84-64 asm W2 
9 pure C 32 bit U2 
10 pure C 32 bit U2 
11 PowerPC 32 bit soft float U2 
12 PowerPC 32 bit hard float U2 
13 x86 asm Ul 
14 x86 asm Ul 
15 x86 asm U2 
16 x86 asm U2 
17 pure C 32 bit U2 


Each of these command sets are relative to the top of the directory containing the uncompressed and 


expanded contents of the distribution file openssl-fips-1.2.4.tar.gz. The command sets are: 


U1: 


./config fipscanisterbuild no-asm 


make 


make install 


U2: 
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./config fipscanisterbuild 
make 
make install 


ms\do fips no-asm 


ms\do fips 


Installation instructions 


1. 


5. 
6. 


Download and copy the distribution file openss-fips-1.2.4.tar.gz to the build system. 
These files can be downloaded from /http:/Avww.openssl.org/sourcel. 


Verify the SHA-1 HMAC digest of the distribution file; see Appendix B. Note that if a suitable 
utility to generate SHA1 HMAC digests is not available, this check will need to be deferred 
until the openssl command is generated in the following step. 


Unpack the distribution 


gunzip -c openssl-fips-1.2.4.tar.gz | tar xf - 
cd openssl-fips-1.2.4 


Execute one of the installation command sets U1, W1, U2, W2 as shown above. No other 
command sets shall be used. 
The resulting fipscanister.o or fipscanister.lib file is now available for use. 


The calling application enables FIPS mode by calling the F/PS mode set() function. 


Note that failure to use one of the specified commands sets exactly as shown will result in a module 
that cannot be considered compliant with FIPS 140-2. 


Linking the Runtime Executable Application 


Note that applications interfacing with the FIPS Object Module are outside of the cryptographic 
boundary. When linking the application with the FIPS Object Module two steps are necessary: 


1. The HMAC-SHA-1 digest of the FIPS Object Module file must be calculated and verified against 
the installed digest to ensure the integrity of the FIPS object module. 


2. AHMAC-SHAI digest of the FIPS Object Module must be generated and embedded in the FIPS 
Object Module for use by the FIPS mode set() function at runtime initialization. 


The OpenSSL distribution contains a reference utility? which can be used to perform the verification of 


8 This utility is the *openssl sha” command with the -hmac option switch. It is included in the FIPS Object Module 
distribution and also in all recent OpenSSL distributions. The version of this utility generated from the FIPS Object 
Module distribution can be used to check the validity of the distribution tarball digest after the fact. Note that in 
principle a software distribution could be corrupted in such a way as to incorrectly return the expected digest. This risk 
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the FIPS Object Module and to generate the new HMAC-SHA-1 digest for the runtime executable 
application. Failure to embed the digest in the executable object will prevent initialization of FIPS 
mode. 


At runtime the FIPS mode set() function compares the embedded HMAC-SHA-1 digest with a 


digest generated from the FIPS Object Module object code. This digest is the final link in the chain of 
validation from the original source to the runtime executable application file. 


is present for all validated products, of course, and would be even harder to detect without visible source code. 
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Appendix B Controlled Distribution File Fingerprint 


The OpenSSL FIPS Object Module v1.2.4 consists of the FIPS Object Module (the fipscanister.o or 
fipscanister.lib contiguous unit of binary object code) generated from the specific source files found in 
the specific special OpenSSL distribution openssl-fips-1.2.4.tar.gz with HMAC-SHA-1 digest of 


c7881d370c551056970aeac83119d62e0f654b7a 


located at http://www.openssl.org/source/openssl-fips-1.2.4.tar.gz. 


This digest can be calculated and displayed with the commands 


openssl shai -hmac etaonrishdlcupfm openssl-fips-1.2.4.tar.gz 


The set of files specified in this tar file (or these files as modified by the aforementioned patch only) 
constitutes the complete set of source files of this module. There shall be no additions, deletions, or 
alterations of this set as used during module build. The OpenSSL distribution tar file (and patch file if 
used) shall be verified using the above HMAC-SHA-1 digest(s). 


The arbitrary 16 byte key of: 


65 74 61 6f 6e 72 69 73 68 64 6c 63 75 70 66 6d 


(equivalent to the ASCII string "etaonrishdlcupfm") is used to generate the HMAC-SHA-1 value for 
the FIPS Object Module integrity check. 


The functionality of all earlier revisions of the FIPS Object Module are subsumed by this latest 
revision, so there is no reason to use older revisions for any new deployments. However, older 
revisions remain valid. The source distribution files and corresponding HMAC-SHA-1 digests are 
listed below: 


openssl-fips-1.2.tar.gz 


URL: http://opensslfoundation.com/testing/validation-1.2/source/openssl-fips-1.2.tar.gz 
digest: 79193087e8115df76d3de4f346f7410df79cf6e0 


opensslfips1.2.crossbuild.diff.gz? (revision 1.2.1) 


URL: http://www.openssl.org/source/openssl-fips-1.2.crossbuild.diff.gz 
digest: 7ac489c3777cb4a30198f878 1ae040030684d672 


openssl-fips-1.2.2.tar.gz 


URL: http://opensslfoundation.com/testing/validation-1.2/source/openssl-fips-1.2.2.tar.g7z 
digest: 4a8e3144895dfe1950f19b7445e8d55f5b09c8d8 


9 The patch is applied to the openssl-fips-1.2.tar.gz source distribution with the command "gunzip -c 
./openssl- fips- 1.2.crossbuild.diff.gz | patch -pO". 
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openssl-fips-1.2.3.tar.gz 


URL: http://www.openssl.org/source/openssl-fips-1.2.3.tar.gz. 
digest: e8fdbcaba53ff94d77317b7147bad16ac7df3b5c 
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